33. 调用REST服务

如果应用需要调用远程REST服务,你可以使用Spring框架的RestTemplate类。由于RestTemplate实例经常在使用前需要自定义,Spring Boot就没有提供任何自动配置的RestTemplate bean,不过你可以通过自动配置的RestTemplateBuilder创建自己需要的RestTemplate实例。自动配置的RestTemplateBuilder会确保应用到RestTemplate实例的HttpMessageConverters是合适的。

以下是典型的示例:

@Service
public class MyBean {

    private final RestTemplate restTemplate;

    public MyBean(RestTemplateBuilder restTemplateBuilder) {
        this.restTemplate = restTemplateBuilder.build();
    }

    public Details someRestCall(String name) {
        return this.restTemplate.getForObject("/{name}/details", Details.class, name);
    }

}

RestTemplateBuilder包含很多有用的方法,可以用于快速配置一个RestTemplate。例如,你可以使用builder.basicAuthorization("user", "password").build()添加基本的认证支持(BASIC auth)。

33.1 自定义RestTemplate

当使用RestTemplateBuilder构建RestTemplate时,可以通过RestTemplateCustomizer进行更高级的定制,所有RestTemplateCustomizer beans将自动添加到自动配置的RestTemplateBuilder。此外,调用additionalCustomizers(RestTemplateCustomizer…)方法可以创建一个新的,具有其他customizers的RestTemplateBuilder

以下示例演示使用自定义器(customizer)配置所有hosts使用代理,除了192.168.0.5

static class ProxyCustomizer implements RestTemplateCustomizer {

    @Override
    public void customize(RestTemplate restTemplate) {
        HttpHost proxy = new HttpHost("proxy.example.com");
        HttpClient httpClient = HttpClientBuilder.create()
                .setRoutePlanner(new DefaultProxyRoutePlanner(proxy) {

                    @Override
                    public HttpHost determineProxy(HttpHost target,
                            HttpRequest request, HttpContext context)
                                    throws HttpException {
                        if (target.getHostName().equals("192.168.0.5")) {
                            return null;
                        }
                        return super.determineProxy(target, request, context);
                    }

                }).build();
        restTemplate.setRequestFactory(
                new HttpComponentsClientHttpRequestFactory(httpClient));
    }

}